home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / www / amitrix / as.lha / AutoSearch / AutoSearch.doc < prev    next >
Text File  |  1998-02-22  |  6KB  |  185 lines
  1. NAME
  2.    AutoSearch.awebrx
  3.  
  4.  
  5. VERSION
  6.    2.4 (21.2.98)
  7.  
  8.  
  9. AUTHOR
  10.    Gabriele Favrin (favrin@tin.it)
  11.  
  12.  
  13. LEGAL THINGS
  14.    The author is in no way responsible for moral and/or material damages that
  15.    his program may cause to people or things. The programmer gave his best
  16.    to limit the problems that this tool may cause, but he is not able to
  17.    guarantee its efficiency in all situations. Using this program, you
  18.    the user, are responsible for all moral, material, civil and penal things.
  19.  
  20.  
  21. REQUIREMENTS AND DISTRIBUTION
  22.    Requires AWeb 3.1 or higher.
  23.  
  24.    This script is freeware, not public domain. It may be spread only in
  25.    unmodified form. Commercial utilization is exclusively allowed to AmiTrix
  26.    and Yvon Rozijn (AWeb author).
  27.  
  28.  
  29. WHAT DOES IT DO?
  30.    This script enhances the AWeb 3.1 autosearch function. Just by typing a
  31.    string in the url field you have access to following features:
  32.  
  33.    o normal autosearch on the configured search engine.
  34.    o configure a new search engine from an easy to use HTML-GUI!
  35.      (no need to type long strings any more...)
  36.    o you can configure more than one engine to search with at the same time!
  37.      In this case results will be showed as resizable IFrames in a page.
  38.    o name completion: type the name of a company and AWeb will try to
  39.      access its site in the "standard" form (www.company[.com, or any other
  40.      domain you have configured]).
  41.  
  42.  
  43. INSTALLATION
  44.    o Create 'AutoSearch' drawer into your AWeb3:Plugins/ path.
  45.      This is the suggested placement, you may use any directory,
  46.      but be careful to use the new path for the configurations below.
  47.  
  48.    o Copy AutoSearch.awebrx and this document to the selected drawer.
  49.  
  50.    o Enable AutoSearch in the AWeb configuration.
  51.      (Network settings/options/enable autosearch)
  52.  
  53.    o Set as the autosearch URL:
  54.      x-aweb:rexx/AwebPath:Plugins/AutoSearch/AutoSearch.awebrx %s
  55.  
  56.    o Assign to the ARexx menu (GUI settings/arexx) the following:
  57.  
  58.      Title: AutoSearchCFG
  59.      Name:  AwebPath:Plugins/AutoSearch/AutoSearch.awebrx
  60.  
  61.      You can also start the script from a Fastlink (GUI settings/buttons):
  62.      or an userkey (GUI settings/keys) by using:
  63.  
  64.      For a fastlink:
  65.  
  66.      Name   : AutoSearchCFG
  67.      Command: RUN AwebPath:Plugins/AutoSearch/AutoSearch.awebrx
  68.  
  69.      For an userkey:
  70.  
  71.      Key:     [the key you prefer]
  72.      Command: RUN AwebPath:Plugins/AutoSearch/AutoSearch.awebrx
  73.  
  74.      You use these settings only to configure the AutoSearch script.
  75.      A single placement in the ARexx menu is probably best.
  76.  
  77.  
  78. CONFIGURATION
  79.    Start the script from the ARexx menu, User Button or type '?' in AWebs url
  80.    field and hit return.
  81.  
  82.    Now you can:
  83.       o choose the domain for name completion (eg. .it , .com , .nl)
  84.       o select one or more search engines to use for autosearch.
  85.  
  86.    Note that the multi search function requires frames to be active
  87.    (browser settings/options/use frames). Without frames the result will
  88.    not be very useful.
  89.  
  90.  
  91. USAGE
  92.    Examples of text typed in the url field:
  93.  
  94.    http://www.cnn.com -> This doesn't start AutoSearch as the url contains
  95.    or www.cnn.com        ':', '.' and '/', characters used by AWeb to
  96.                          distinguish an url from an autosearch request.
  97.  
  98.    cnn                -> This one searches 'cnn' on the search engine(s)
  99.                          selected in the configuration.
  100.  
  101.    @cnn               -> This one loads http://www.cnn.com (or other
  102.                          domain, if differently configured).
  103.  
  104.    ?                  -> starts configuration function. The same happens
  105.                          when calling autosearch.awebrx without arguments
  106.                          (eg. from a menu, fast link or an user key).
  107.  
  108.  
  109. AVAILABLE ENGINES
  110.    The following engines are currently supported:
  111.  
  112.    AltaVista (default)
  113.    Lycos
  114.    Yahoo
  115.    Excite
  116.    Northern Light
  117.  
  118.    Need others? Write me! Do NOT add them yourself!
  119.  
  120.  
  121. HISTORY
  122.    Version 1.0
  123.       o First release.
  124.  
  125.    Version 1.1
  126.       o Added @?.
  127.  
  128.    Version 2.0
  129.       o Rewrote program (almost :)
  130.       o Added support for multiple search engines.
  131.       o Added new easy to use configuration gui.
  132.       o Changed format of the configuration file.
  133.       o Changed @? to ?
  134.       o Various other internal changes.
  135.  
  136.    Version 2.1
  137.       o Configuration now displays currently selected engines.
  138.         (Thanks to Yvon Rozijn!)
  139.       o Speeded up configuration save.
  140.       o Added support for multi search with frames disabled and
  141.         improved the HTML code.
  142.       o Now autosearch can manage up to 99 servers.
  143.       o Made configuration location not hardcoded. Now config is searched
  144.         for in the same directory as the script. (Thanks to William Parker
  145.         for the routine).
  146.       o Fixed Northern Light name :-)
  147.       o Little internal changes.
  148.       o Fixed errors in documentation.
  149.  
  150.    Version 2.3
  151.       o Improved HTML source of the autosearch page.
  152.  
  153.    Version 2.4
  154.       o Domain name wasn't saved.
  155.       o Some more little internal changes.
  156.  
  157.  
  158. TO-DO
  159.    o JavaScript improvements in settings page.
  160.    o (maybe) split configuration from main program and keep engines
  161.      informations in a separate file.
  162.  
  163.  
  164. FUTURE AND UPDATES
  165.    Any suggestion, bug report or critic is welcome!  Write me at:
  166.  
  167.    E-Mail:   favrin@tin.it
  168.    FidoNet:  2:333/726.8
  169.  
  170.    Please write me in italian or english, thank you.
  171.  
  172.    The most up to date version of this plugin is usually available from:
  173.    http://www.amitrix.com/aweb.html
  174.  
  175.  
  176. CHILDWARE
  177.    This software is "CHILDWARE". The author explicitly asks whoever uses this
  178.    program to make a donation toward a beneficial corporate body which works
  179.    in help of the children, in any form or way.
  180.  
  181.    If you don't know any, ask your local post office and inform yourself on
  182.    how to make a payment to The UNICEF.
  183.  
  184.    The amount of the offer is up to you , but please do it!
  185.